home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / PRUS101.ZIP / FDOS.DOK < prev    next >
Text File  |  1994-09-05  |  8KB  |  181 lines
  1.  
  2.                  /////////////////////\\\\\\\\\\\\\\\\\\\\\\\
  3.                        Dokumentation zur FIDO Unit FDOS
  4.                  \\\\\\\\\\\\\\\\\\\\\///////////////////////
  5.  
  6.                                  RELEASE 1.01
  7.                                  ^^^^^^^^^^^^
  8.  
  9.   =========================================================================
  10.   Autor: Orazio Czerwenka, 2:2450/540.55 @ FidoNet, St.Augustin, 12.08.1994
  11.   Autor: Sieghard Schicktanz, 2:2480/642.25 @ FidoNet, Muenchen, 02.08.1994
  12.   Autor: Peter Schuette,  2:2452/117.19 @ FidoNet,   Eschweiler, --.--.----
  13.   =========================================================================
  14.  
  15.      1. DOS-bezogene Funktionen für File-Operationen etc.
  16.      ----------------------------------------------------
  17.  
  18.         Die Unit  FDOS stellt  zur Zeit überwiegend Routinen für File-
  19.         Operationen zur Verfügung.
  20.  
  21.         Ersatzroutinen für die DOS-Funktionen GetDate und GetTime wer-
  22.         den in der PRUSSG-Unit FDATE bereitgestellt. Es empfiehlt sich
  23.         jedoch aus Gründen der Speicheroptimierung nur auf diese zu zu
  24.         greifen, wenn ohnehin noch weitere Routinen der Unit FDATE be-
  25.         nötigt werden.
  26.  
  27.         In der Unit FDOS wird derzeit noch auf die TP-Standardunit DOS
  28.         sowie auf die PRUSSG-Unit FSTR (für EnsureBackslash) zugegrif-
  29.         fen.
  30.  
  31.         Die File-bezogenen Routinen sind in den include files FFILES.
  32.         DEC (Interface-Teil) und FFILES.INC (Implementation-Teil) ent-
  33.         halten.
  34.  
  35.         **************************************************************
  36.  
  37.  
  38.      2. Kurzbeschreibung:
  39.      --------------------
  40.  
  41.         DelFile .............. Löscht ein File, ohne  daß  dieses  zuvor
  42.                                über Assign zugewiesen werden muß.
  43.         Execute .............. Startet ein Programm oder  internes  DOS-
  44.                                Kommando ähnlich der DOS-Prozedur Exec.
  45.                                Durch  Reallozierung  des  Speichers  ist
  46.                                Execute  jedoch   speicherschonender  als
  47.                                Exec. SwapVectors wird automatisch aufge-
  48.                                rufen.
  49.         FileExists ........... Testet  Vorhandensein   des  uebergebenen
  50.                                Files (incl. Pfad).
  51.         FileOnPath ........... Sucht  angegebenes File  (incl. Pfad)  in
  52.                                allen Directories,  die  in der  Environ-
  53.                                ment-Variablen PathVariable stehen,  bzw.
  54.                                im PATH, wenn diese als Leerstring  ange-
  55.                                gegeben wurde.
  56.                                Mit  prime = false  wird  eine  begonnene
  57.                                Suche fortgesetzt,
  58.                                mit  prime = true  wird ein  Neustart der
  59.                                Suche erzwungen.
  60.         LogicalDrives ........ Gibt eine Liste der verfügbaren logischen
  61.                                Laufwerke in Form eines Strings zurück.
  62.         RenFile .............. Benennt  eine  Datei  um,  ohne daß diese
  63.                                zuvor mit Assign zugewiesen werden muß.
  64.         SearchFileAttr ....... Typisierte   Konstante   die   die  File-
  65.                                Attribute der über FileOnPath zu  suchen-
  66.                                den Dateien definiert.
  67.  
  68.  
  69.      3. Detaillierte Beschreibung:
  70.      -----------------------------
  71.  
  72.         ===============================================================
  73.         DelFile
  74.         ---------------------------------------------------------------
  75.         ERSTAUTOR    ...  Peter Holschbach, 2:2450/660.3 @ FidoNet
  76.  
  77.         ERSTDATUM    ...  ??.??.19??    LETZTE ÄNDERUNG ...  ??.??.19??
  78.         ---------------------------------------------------------------
  79.  
  80.         BESCHREIBUNG ...  löscht ein File, ohne daß dieses zuvor über
  81.                           Assign zugewiesen werden muß und liefert den
  82.                           Status der Dateioperation zurück.
  83.  
  84.         DEKLARATION  ...  function DelFile(FileName: String): Integer;
  85.  
  86.         PARAMETER    ...  FileName - die zu löschende Datei
  87.  
  88.         ERGEBNIS     ...  eine Variable des Typs INTEGER, die den
  89.                           Status der Dateioperation enthält
  90.  
  91.  
  92.         ===============================================================
  93.         Execute
  94.         ---------------------------------------------------------------
  95.         ERSTAUTOR    ...  Keld R. Hansen, UNKNOWN NM ADDRESS
  96.  
  97.         ERSTDATUM    ...  ??.??.19??    LETZTE ÄNDERUNG ...  ??.??.19??
  98.         ---------------------------------------------------------------
  99.  
  100.         BESCHREIBUNG ...  führt ein Programm oder ein internes DOS-
  101.                           Kommando erst auf, nachdem zuvor möglichst
  102.                           viel Speicher realloziert wurde.
  103.                           Der Status der Operation wird als Ergebnis
  104.                           zurückgeliefert.
  105.  
  106.         DEKLARATION  ...  function execute(Name : PathStr ;
  107.                                            Tail : ComSTR) : Word;
  108.  
  109.         PARAMETER    ...  Name - Name der auszuführenden Datei
  110.                           Tail - die an die Datei zu übergebenden
  111.                                  Argumente.
  112.  
  113.         ERGEBNIS     ...  eine Variable des Typs WORD, die den
  114.                           Status der Dateioperation enthält
  115.  
  116.  
  117.         ===============================================================
  118.         FileExists
  119.         ---------------------------------------------------------------
  120.         ERSTAUTOR    ...  Wilbert van Leijen, UNKNOWN NM ADDRESS
  121.  
  122.         ERSTDATUM    ...  ??.??.19??    LETZTE ÄNDERUNG ...  08.06.1994
  123.  
  124.         MODIFIKATION ...  Horst Kraemer
  125.         ---------------------------------------------------------------
  126.  
  127.         BESCHREIBUNG ...  überprüft ob eine mit vollem Pfad angegebene
  128.                           Datei existiert.
  129.  
  130.         DEKLARATION  ...  function FileExists(FileName:PathStr):boolean;
  131.  
  132.         PARAMETER    ...  FileName - die zu überprüfende Datei
  133.                                      inkl. Pfad
  134.  
  135.         ERGEBNIS     ...  eine Variable des Typs BOOLEAN:
  136.                           TRUE  - wenn die zu überprüfende Datei
  137.                                   existiert
  138.                           FALSE - wenn die zu überprüfende Datei
  139.                                   nicht existiert
  140.  
  141.  
  142.         ===============================================================
  143.         FileOnPath
  144.         ---------------------------------------------------------------
  145.         ERSTAUTOR    ...  Sieghard Schicktanz, 2:2480/642.25 @ FidoNet
  146.  
  147.         ERSTDATUM    ...  ??.??.19??    LETZTE ÄNDERUNG ...  12.08.1994
  148.  
  149.         MODIFIKATION ...  Orazio Czerwenka
  150.         ---------------------------------------------------------------
  151.  
  152.         BESCHREIBUNG ...  überprüft ob eine Datei innerhalb einer Path-
  153.                           variablen vorhanden ist.
  154.  
  155.         DEKLARATION  ...  function FileOnPath (FileSpec: PathStr;
  156.                                                PathVariable: String;
  157.                                                prime: boolean): ComStr;
  158.  
  159.         PARAMETER    ...  FileSpec     - die zu findende(n) Datei(en)
  160.                           Pathvariable - eine Umgebungsvariable, in der
  161.                                          Regel PATH, die die zu durch-
  162.                                          suchenden Verzeichnisse enthält
  163.                           prime        - gibt an, ob eine neue Suche be-
  164.                                          gonnen werden soll
  165.  
  166.         ERGEBNIS     ...  eine Variable des Typs PathStr, die den voll-
  167.                           ständigen Suchpfad der Datei(en) zurückliefert.
  168.  
  169.         File-Suchroutine, die den DOS-Pfad aus dem Environment auswertet,
  170.         um das (die) zu suchende(n) File(s) zu lokalisieren.
  171.         Falls der uebergebene Filename keine Extension hat, wird
  172.         automatisch nach COM- und EXE-Files, in dieser Reihenfolge,
  173.         gesucht.
  174.         Bei Bedarf kann auch eine andere Environmentvariable als PATH
  175.         zum Auffinden der Files benutzt werden.
  176.         Mit dem Parameter prime besteht die Moeglichkeit, zwangsweise
  177.         eine neue Suche zu starten.
  178.  
  179.  
  180.  
  181.         { to be continued ... }